home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Freeware / USBDeview v1.27 / usbdeview.exe / readme.txt next >
Text File  |  2008-10-28  |  16KB  |  427 lines
  1.  
  2.  
  3.  
  4. USBDeview v1.27
  5. Copyright (c) 2006 - 2008 Nir Sofer
  6. Web Site: http://www.nirsoft.net
  7.  
  8.  
  9.  
  10. Description
  11. ===========
  12.  
  13. USBDeview is a small utility that lists all USB devices that currently
  14. connected to your computer, as well as all USB devices that you
  15. previously used.
  16. For each USB device, exteneded information is displayed: Device
  17. name/description, device type, serial number (for mass storage devices),
  18. the date/time that device was added, VendorID, ProductID, and more...
  19. USBDeview also allows you to uninstall USB devices that you previously
  20. used, and disconnect USB devices that are currently connected to your
  21. computer.
  22. You can also use USBDeview on a remote computer, as long as you login to
  23. that computer with admin user.
  24.  
  25. License
  26. =======
  27.  
  28. This utility is released as freeware. You are allowed to freely
  29. distribute this utility via floppy disk, CD-ROM, Internet, or in any
  30. other way, as long as you don't charge anything for this. If you
  31. distribute this utility, you must include all files in the distribution
  32. package, without any modification !
  33.  
  34.  
  35.  
  36. Disclaimer
  37. ==========
  38.  
  39. The software is provided "AS IS" without any warranty, either expressed
  40. or implied, including, but not limited to, the implied warranties of
  41. merchantability and fitness for a particular purpose. The author will not
  42. be liable for any special, incidental, consequential or indirect damages
  43. due to loss of data or any other reason.
  44.  
  45.  
  46.  
  47. System Requirement
  48. ==================
  49.  
  50. This utility works on Windows 2000/XP/2003/Vista. Windows 98/ME is not
  51. supported. In order to disable/enable USB items under Vista with UAC
  52. turned on, you should right click on USBDeview and choose 'Run As
  53. Administrator'.
  54.  
  55.  
  56.  
  57. Versions History
  58. ================
  59.  
  60.  
  61. * Version 1.27
  62.   o Added new option: Open In RegEdit.
  63.  
  64. * Version 1.26
  65.   o The 'Advanced Options' dialog-box is now resizable.
  66.   o Added 'USB Hub' column (yes/no).
  67.  
  68. * Version 1.25
  69.   o Added Disable+Enable option - gives you the affect similar to
  70.     unplugging and then plugging back the device.
  71.   o Added 'Open Drive' option (For USB flash drives).
  72.  
  73. * Version 1.22
  74.   o Added new command line options: /remove_all_connected,
  75.     /remove_all_disconnected
  76.   o Fixed bug: using /remove_all removed also the USB hubs and caused
  77.     the USB to stop working until restarting the computer.
  78.  
  79. * Version 1.21
  80.   o Added new option: Select Another Font.
  81.  
  82. * Version 1.20
  83.   o Added new command-line options to disable/enable/remove USB
  84.     devices.
  85.  
  86. * Version 1.18
  87.   o Fixed bug: The main window lost the focus when the user switched
  88.     to another application and then returned back to USBDeview.
  89.  
  90. * Version 1.17
  91.   o Fixed bug in saving as comma-delimited file when description or
  92.     name fields contained comma character.
  93.  
  94. * Version 1.16
  95.   o Added support for saving comma-delimited (.csv) files.
  96.   o Added new command-line option: /scomma
  97.  
  98. * Version 1.15
  99.   o New options: Disable/enable the selected USB devices (Works only
  100.     with admin rights)
  101.   o New Option: Start USBDeview As Hidden (Only when 'Put Icon On
  102.     Tray' is turned on)
  103.  
  104. * Version 1.12
  105.   o The configuration is now saved to a file, instead of the Registry.
  106.   o New option: Display a balloon in the tray icon when a new device
  107.     is connected (only for Windows XP or above).
  108.  
  109. * Version 1.11
  110.   o Fixed bug: Changing the status of 'Put Icon On Tray' also changed
  111.     the status of 'Show Tooltips'.
  112.  
  113. * Version 1.10
  114.   o New Option: Put Icon On Tray
  115.   o New Option: AutoPlay on selected devices.
  116.   o New Option: AutoPlay When Device Is Connected.
  117.   o New Option: Execute a command when you insert a USB device. (In
  118.     Advanced Options)
  119.   o New Option: Disconnect All Devices.
  120.  
  121. * Version 1.06
  122.   o Added Disconnect/Uninstall buttons to the toolbar.
  123.  
  124. * Version 1.05
  125.   o New command-line option: /regfile
  126.   o New option: Display USB Hubs.
  127.  
  128. * Version 1.03 - New command-line option: /stop_by_class
  129. * Version 1.02 - New option: Display devices without drivers.
  130. * Version 1.01 - Fixed bug: In some computers, the USB devices list was
  131.   loaded from the wrong hardware configuration.
  132. * Version 1.00 - First release.
  133.  
  134.  
  135.  
  136. Using USBDeview
  137. ===============
  138.  
  139. USBDeview doesn't require any installation process or additional DLL
  140. files. Just copy the executable file (USBDeview.exe) to any folder you
  141. like, and run it.
  142. The main window of USBDeview displays all USB devices installed on your
  143. system. You can select one or more items, and then disconnect (unplug)
  144. them , uninstall them, or just save the information into text/xml/html
  145. file.
  146.  
  147.  
  148.  
  149. USBDeview Columns Description
  150. =============================
  151.  
  152.  
  153. * Device Name: Specifies the device name. For some device, this column
  154.   may display meaningless name, like "USB Device". If the device name is
  155.   meaningless, try to look at the Description column.
  156. * Device Description: The description of the device.
  157. * Device Type: The device type, according to USB class code. For more
  158.   information about USB classes: USB Class Codes.
  159. * Connected: Specifies whether the device is currently connected to
  160.   your computer. If the device is connected, you can use the 'Disconnect
  161.   Selected Devices' option (F9) to disconnect the device.
  162. * Safe To Unplug: Specifies whether it's safe to unplug the device from
  163.   the USB plug without disconnecting it first. If the value of this
  164.   column is true, and you want to unplug this device, you must first
  165.   disconnect this device by using the 'Disconnect Selected Devices'
  166.   option (F9) of USBDeview utility, or by using the 'Unplug or Eject
  167.   Hardware' utility of Windows operating system.
  168. * Drive Letter: Specifies the drive letter of the USB device. This
  169.   column is only relevant to USB flash memory devices and to USB CD/DVD
  170.   drives. Be aware that USBDeview cannot detect drive letters of USB
  171.   hard-disks.
  172. * Serial Number: Specifies the serial number of the device. This column
  173.   is only relevant to mass storage devices (flash memory devices, CD/DVD
  174.   drives, and USB hard-disks).
  175. * Created Date: Specifies the date/time that the device was installed.
  176.   In most cases, this date/time value represents the time that you first
  177.   plugged the device to the USB port. However, be aware that in some
  178.   circumstances this value may be wrong.
  179. * Last Plug/Unplug Date: Specifies the last time that you
  180.   plugged/unplugged the device. This date value is lost when you restart
  181.   the computer.
  182. * VendorID/ProductID: Specifies the VendorID and ProductID of the
  183.   device. For unofficial list of VendorID/ProductID, click here.
  184. * USB Class/Subclass/Protocol: Specifies the Class/Subclass/Protocol of
  185.   the device according to USB specifications. For more information about
  186.   USB classes: USB Class Codes.
  187. * Hub/Port: Specifies the hub number and port number that the device
  188.   was plugged into. This value is empty for mass storage devices.
  189.  
  190.  
  191.  
  192. AutoPlay
  193. ========
  194.  
  195. Starting from version 1.10, USBDeview allows you to automatically run a
  196. file on USB flash memory devices, according to AutoRun.inf filename. You
  197. can manually activate the AutoPlay feature by selecting the desired
  198. device and pressing F8. Alternatively, You can check the "AutoPlay When
  199. Device Is Connected" option, and then the AutoPlay feature will be
  200. automatically activated when you insert a USB flash memory device.
  201. Be aware that this feature only works if USBDeview detects the drive
  202. letter of the device.
  203.  
  204.  
  205.  
  206. Execute a command when you insert a USB device
  207. ==============================================
  208.  
  209. Starting from version 1.10, USBDeview allows you to execute a command
  210. from exe/cmd/bat file in every time that insert a USB device to your
  211. system. In order to use this feature, go to 'Options->Advanced Options',
  212. select the 'Execute..' check-box, and type the exe/cmd file that you want
  213. to run. You can also use the following special variables in this command
  214. string: %device_name%, %device_desc%, %drive%, %serial_number%, %vid%,
  215. %pid%
  216. USBDeview will automatically replace these variables with the appropriate
  217. data of the device that you inserted. For example, if you want to pass to
  218. your exe file 2 parameters - the serial number of the device, and the
  219. drive letter:
  220. c:\temp\test.exe "%serial_number%" "%drive%"
  221.  
  222.  
  223.  
  224. Known Limitations/Issues
  225. ========================
  226.  
  227.  
  228. * For all devices except 'Mass Storage' Devices: If you plug a device
  229.   to one USB port, and then you plug the same device to another USB port,
  230.   a new record of the same device will be created for each USB port that
  231.   you plug. So if you see multiple lines for exactly the same device, it
  232.   means that you plugged it to different USB ports. The USB ports that
  233.   you plugged are specified in 'Hub/Port' column.
  234.   However, for 'Mass Storage' device, only one record is created for each
  235.   device, even if you plug it to different USB port.
  236. * When a USB device is added/removed on your local computer, UDBDeview
  237.   utility automatically updates the list of USB devices.
  238.   But... If you UDBDeview is connected to a remote computer, the list
  239.   won't refresh automatically when a device is added or removed. You must
  240.   refresh it manually, by pressing F5 key.
  241.  
  242.  
  243.  
  244. Connecting To Remote Computer
  245. =============================
  246.  
  247. The following command-line options allows you to connect to remote
  248. computers. You must login to the remote computer with admin user in order
  249. to use these options.
  250. * /remote <\\Computer Name>
  251.   Allows you to connect a single remote computer.
  252.   For Example:
  253.   USBDeview.exe /remote \\MyComp
  254. * /remotefile <Computers List File>
  255.   Allows you to connect multiple computers, and view all their USB
  256.   activity in one window. The computers list file should be a simple
  257.   Ascii text file with computer names separated by colon, semicolon,
  258.   space, tab characters or CRLF.
  259.   For Example:
  260.   USBDeview.exe /remotefile "c:\temp\comp.txt"
  261.  
  262.  
  263.  
  264. Connecting To external SYSTEM registry file
  265. ===========================================
  266.  
  267. If you have the 'SYSTEM' registry file of external operating system, you
  268. can use the following command-line option to read the USB devices list
  269. from it:
  270. /regfile <SYSTEM Registry File>
  271.  
  272. For Example:
  273. USBDeview.exe /regfile "c:\temp\regfiles\SYSTEM"
  274. USBDeview.exe /regfile "d:\windows\system32\config\SYSTEM"
  275.  
  276. This option has some limitations:
  277. * You cannot read a Registry file of Windows XP/2003/Vista from Windows
  278.   2000 Machine.
  279. * USBDeview works in read-only mode. (You cannot uninstall a device
  280.   from external file)
  281.  
  282.  
  283.  
  284. Stop/Disconnect Command-Line Options
  285. ====================================
  286.  
  287.  
  288. * /stop {/showmsg} {\\RemoteComputer} <Device Name>
  289.   Stop/disconnect a USB device by specifying its name or description.
  290.   You don't have to specify the whole name or description. You can also
  291.   specify only a part of the name or description string, and USBDeview
  292.   will identify it. For example, If the device name is 'Kingston
  293.   DataTraveler 2.0', you can simply put 'kingston' or 'DataTraveler' in
  294.   the device name parameter, and USBDeview will disconnect the right
  295.   device.
  296.   If you want that a message/balloon will be displayed after the device
  297.   is disconnected, add the '/showmsg' parameter. (Windows 2000 displays a
  298.   message-box, Windows XP displays a balloon)
  299.   If you want to disconnect a device in a remote computer, specify the
  300.   remote computer name, with \\ prefix. You must login to the remote
  301.   computer with admin rights in order to do that.
  302.   Examples:
  303.   USBDeview.exe /stop /showmsg "DVD RW"
  304.   USBDeview.exe /stop "DataTraveler"
  305.   USBDeview.exe /stop \\comp01 "SanDisk Cruzer"
  306.  
  307.  
  308. * /stop_by_serial {/showmsg} {\\RemoteComputer} <Device Name>
  309.   Similar to /stop command, but instead of specifying a device name, you
  310.   should specify the serial number of the device. Works only with mass
  311.   storage devices.
  312.   Examples:
  313.   USBDeview.exe /stop_by_serial ea051261
  314.   USBDeview.exe /stop_by_serial /showmsg 876534513
  315.  
  316.  
  317. * /stop_by_drive {/showmsg} {\\RemoteComputer} <Device Name>
  318.   Stop/disconnect a USB device by specifying its drive letter. Works only
  319.   with USB flash drives and CD/DVD devices.
  320.   Examples:
  321.   USBDeview.exe /stop_by_drive g:
  322.   USBDeview.exe /stop_by_drive /showmsg f:
  323.   USBDeview.exe /stop_by_drive /showmsg \\comp02 t:
  324.  
  325.  
  326. * /stop_by_class {/showmsg} {\\RemoteComputer} <USB Class;USB
  327.   SubClass;USB Protocol>
  328.   Stop/disconnect a USB device by specifying the class/subclass/protocol
  329.   combination.
  330.   For example, if you want to stop all 'Mass Storage' devices, you should
  331.   specify the following class/subclass/protocol combination: 08;06;50
  332.   Examples:
  333.   USBDeview.exe /stop_by_class /showmsg 08;06;50
  334.   USBDeview.exe /stop_by_class 03;01;02
  335.  
  336.  
  337. * /stop_all {/showmsg} {\\RemoteComputer}
  338.   Stop/disconnect all USB devices currently connected to your computer.
  339.  
  340.  
  341.  
  342.  
  343.  
  344. Disable/Enable/Remove Command-Line Options
  345. ==========================================
  346.  
  347. Starting from version 1.20, you can also use the following commands to
  348. disable, enable or remove USB devices from command-line:
  349. * /disable {\\RemoteComputer} <Device Name>
  350. * /disable_by_serial {\\RemoteComputer} <Device Name>
  351. * /disable_by_drive {\\RemoteComputer} <Device Name>
  352. * /disable_by_class {\\RemoteComputer} <USB Class;USB SubClass;USB
  353.   Protocol>
  354. * /disable_all {\\RemoteComputer}
  355. * /enable {\\RemoteComputer} <Device Name>
  356. * /enable_by_serial {\\RemoteComputer} <Device Name>
  357. * /enable_by_drive {\\RemoteComputer} <Device Name>
  358. * /enable_by_class {\\RemoteComputer} <USB Class;USB SubClass;USB
  359.   Protocol>
  360. * /enable_all {\\RemoteComputer}
  361. * /remove {\\RemoteComputer} <Device Name>
  362. * /remove_by_serial {\\RemoteComputer} <Device Name>
  363. * /remove_by_drive {\\RemoteComputer} <Device Name>
  364. * /remove_by_class {\\RemoteComputer} <USB Class;USB SubClass;USB
  365.   Protocol>
  366. * /remove_all {\\RemoteComputer}
  367. * /remove_all_connected - Remove all connected USB devices.
  368. * /remove_all_disconnected - Remove all disconnected USB devices.
  369.  
  370.  
  371.  
  372. Save Command-Line Options
  373. =========================
  374.  
  375.  
  376.  
  377. /stext <Filename>
  378. Save the list of all USB devices into a regular text file.
  379.  
  380. /stab <Filename>
  381. Save the list of all USB devices into a tab-delimited text file.
  382.  
  383. /scomma <Filename>
  384. Save the list of all USB devices into a comma-delimited text file.
  385.  
  386. /stabular <Filename>
  387. Save the list of all USB devices into a tabular text file.
  388.  
  389. /shtml <Filename>
  390. Save the list of all USB devices into HTML file (Horizontal).
  391.  
  392. /sverhtml <Filename>
  393. Save the list of all USB devices into HTML file (Vertical).
  394.  
  395. /sxml <Filename>
  396. Save the list of all USB devices to XML file.
  397.  
  398.  
  399.  
  400. Translating USBDeview to other languages
  401. ========================================
  402.  
  403. In order to translate USBDeview to other language, follow the
  404. instructions below:
  405. 1. Run USBDeview with /savelangfile parameter:
  406.    USBDeview.exe /savelangfile
  407.    A file named USBDeview_lng.ini will be created in the folder of
  408.    USBDeview utility.
  409. 2. Open the created language file in Notepad or in any other text
  410.    editor.
  411. 3. Translate all string entries to the desired language. Optionally,
  412.    you can also add your name and/or a link to your Web site.
  413.    (TranslatorName and TranslatorURL values) If you add this information,
  414.    it'll be used in the 'About' window.
  415. 4. After you finish the translation, Run USBDeview, and all translated
  416.    strings will be loaded from the language file.
  417.    If you want to run USBDeview without the translation, simply rename
  418.    the language file, or move it to another folder.
  419.  
  420.  
  421.  
  422. Feedback
  423. ========
  424.  
  425. If you have any problem, suggestion, comment, or you found a bug in my
  426. utility, you can send a message to nirsofer@yahoo.com
  427.